Fileview by Snake River Software Version 1.14 Program and Documentation Copyright 1990-1991 All Rights Reserved Microsoft and MS-DOS are registered trademarks and Windows is a trademark of Microsoft Corporation. Fileview 1.14 ______________________________________________________________________ Contents* Contents* Contents* 1. 1. 1. Overview Overview Overview ................................ ................................ ..................................... ..... ..... 1 1 1 2. 2. 2. Notations Notations Notations ................................ ................................ .................................... .... .... 1 1 1 3. 3. 3. Acknowledgements Acknowledgements Acknowledgements ............................. ............................. ............................. 1 1 1 4. 4. 4. System Requirements System Requirements System Requirements .......................... .......................... .......................... 1 1 1 5. 5. 5. Installation Installation Installation ................................ ................................ ................................. . . 2 2 2 6. 6. 6. Usage Usage Usage ................................ ................................ ........................................ ........ ........ 2 2 2 7. 7. 7. Commands Commands Commands ................................ ................................ ..................................... ..... ..... 3 3 3 8. 8. 8. Keys Keys Keys ................................ ................................ ......................................... ......... ......... 5 5 5 9. 9. 9. Searching Searching Searching ................................ ................................ .................................... .... .... 6 6 6 10. 10. 10. Messages Messages Messages ................................ ................................ ..................................... ..... ..... 7 7 7 11. 11. 11. WIN.INI WIN.INI WIN.INI ................................ ................................ ...................................... ...... ...... 8 8 8 12. 12. 12. License Information License Information License Information .......................... .......................... .......................... 9 9 9 13. 13. 13. Ordering Information Ordering Information Ordering Information ......................... ......................... ......................... 11 11 11 14. 14. 14. Rates Rates Rates ................................ ................................ ........................................ ........ ........ 10 10 10 A. A. A. Single User License Application Single User License Application Single User License Application .............. .............. .............. 12 12 12 B. B. B. Site License Application Site License Application Site License Application ..................... ..................... ..................... 13 13 13 * Page numbers are based on the printed version. The *.txt version of this document that is distributed on disk may not be the same. The page numbers should provide an approximate place to refer to. __________________________________________________________________________ Date: March 26, 1991 Fileview 1.14 ______________________________________________________________________ 1. 1. 1. Overview Overview Overview This documentation is for release 1.14 of Fileview. Fileview is a Microsoft Windows based tool that allows you to browse files on your hard-drive or network drives. Unlike other Windows browsers, Fileview does not load the file into memory, allowing you to browse files that are larger than available memory while leaving room for other windows applications to run. To use Fileview, select a file to browse from the File/Open dialog as you would select a file in any other windows program. Once you are browsing a file, you can scroll through it and search for text using DOS style or Regular Expression style search patterns. 2. 2. 2. Notations Notations Notations The following notations are used in this manual: [text] is used to identify optional information. If the option is not specified, the default action will be taken. An exception is in the discussion of the WIN.INI file. WIN.INI section headers are identified as [text] [text] [text]. These sections are boldfaced to assist in their identification whereas [options] are not normally boldfaced. Hopefully, context and the use of boldfacing will distinguish these two uses. 3. 3. 3. Acknowledgements Acknowledgements Acknowledgements The regular expression routines were derived from routines written by Henry Spencer and copyright in 1986 by the University of Toronto. 4. 4. 4. System Requirements System Requirements System Requirements Fileview runs within the Microsoft Windows. Minimum System requirements include: __________________________________________________________________________ Date: March 26, 1991 Page: 1 Fileview 1.14 ______________________________________________________________________ Microsoft Windows 3.X or higher DOS 3.X or higher Approximately 70K memory* Approximately 50K disk space Windows compatible mouse * Memory available within the Windows environment. The memory required by Fileview varies with use. The minimum memory is approximately 70K. 5. 5. 5. Installation Installation Installation Fileview is easy to install. Simply copy all distribution files to the disk/directory where you want to run Fileview from. This will usually be \windows. Note that you may install Fileview in a directory that is not in your environment path if you provide the path to the program manager. However, the Fileview.hlp file must be in the environment path for it be found when help is requested. If you install Fileview in a path that is not in your environment path, installing it in the \windows directory is recommended. All configuration options reside in your WIN.INI file. All of these can be set within Fileview. 6. 6. 6. Usage Usage Usage Fileview is invoked like other windows programs. From the WINDOWS Program Manager, double click a Program Group that contains Fileview, then double click on the Fileview icon. If you have installed Fileview as a program under Filefind's user defined menu, you may invoke it from Filefind and automatically open and browse the selected file. __________________________________________________________________________ Date: March 26, 1991 Page: 2 Fileview 1.14 ______________________________________________________________________ 7. 7. 7. Commands Commands Commands _ F _ F _ File ile ile _ Open Invokes a dialog to choose a file to browse. The dialog consists of one edit field and two list boxes. The file name with a path or wild cards may be entered. If the file specification does not contain wild cards, Fileview will attempt to open the file. If the file specification includes wild cards, Fileview will list all matching files in the path, and change the default extension to match the specification extension. The extension will remain until changed again, or the program is terminated. A file list box allows a specific file to be picked without typing the filename. A directory list box allows the directory tree to be traversed and the disk drive to be changed. _ Refresh File Reloads the current file. Fileview loads a series of pointers into the file the you are using. If this file becomes changed (because you are changing it with NOTEPAD for example), Fileview will not display the file correctly. The _ Refresh File command instructs Fileview to reload its pointers so the file is correctly displayed. This command is only needed if the file is changed while you are viewing it. _ Select Printer Selects the printer to use. The printer selected will remain the printer to use until another is selected or you close the program. If no printer is selected, the windows default printer is used. Setup... within this dialog opens the setup dialog for the particular printer selected. The details of the Setup... dialog vary with the printer selected. Control Panel... within this dialog will invoke the Control Panel(CONTROL.EXE CONTROL.EXE CONTROL.EXE). This program must reside in the windows directory (Whatever directory you originally installed windows in). Print _ File Prints the file. Print _ Window Prints the portion of the file shown by __________________________________________________________________________ Date: March 26, 1991 Page: 3 Fileview 1.14 ______________________________________________________________________ the window. E_ xit Shuts down the program. _ E _ E _ Edit dit dit _ Search Invokes a dialog to specify search criteria _ Continue Search Searches from the top line in the display downward for the last search string specified. _ O _ O _ Options ptions ptions _ ASCII Switches the display mode to ASCII. ASCII is not always available. Fileview examines the beginning of the file to determine whether ASCII mode is feasible. If not, ASCII mode is disabled. _ Hex Switches the display mode to Hexadecimal. _ Format Invokes a dialog that allows the display to be tailored. Settings in this dialog may be saved. Saved settings may also be restored. _ Register User Invokes a dialog to enter a license id. _ H _ H _ Help elp elp Invokes the windows help program. Once invoked, you can select from the various help topics as in other windows 3.x programs. You can open other help files if you wish. When FileView is closed, the windows help program will also be closed (if no other application is using WinHelp). _ Index The main index is displayed _ Keys Displays help for Fileview's use of keys. A_ bout Invokes the About dialog. Additional information about the selected file is included in the About dialog. This information includes the file path, Size in bytes, size in records, date and time created or last modified, and the file attributes. __________________________________________________________________________ Date: March 26, 1991 Page: 4 Fileview 1.14 ______________________________________________________________________ 8. 8. 8. Keys Keys Keys Ctrl+R Refresh the file => Scroll 1 character to the right <= Scroll 1 character to the left. /\ Scroll 1 character up \/ Scroll 1 character down Home Position at the top of the file Ctrl+Home Position at the leftmost position of the file End Position at the end of the file Ctrl+End Position at the rightmost position of the file PgUp Scrolls 1 screen up Ctrl+PgUp Scrolls 1 screen to the left PgDn Scrolls 1 screen down Ctrl+PgDn Scrolls 1 screen to the right F3 Repeat search forward Shift+F3 Invoke the Search specification Dialog. Alt+F4 Exit the application. Crtl+F12 Invoke the Open dialog. __________________________________________________________________________ Date: March 26, 1991 Page: 5 Fileview 1.14 ______________________________________________________________________ 9. 9. 9. Searching Searching Searching Fileview will the file for a specified string. To specify and start a search, invoke the Edit/Search Edit/Search Edit/Search command. Once the OK button is pressed, the search will start at the top of the file and continue until the string is found or the end of the file is encountered. Fileview searches a single record at a time, so the search string can not span a line. Search For: Enter the text that should be search for. The string is entered as a wild card string or a regular expression depending on which search type is chosen. Ignore Case: If checked, the search ignores case in the search string and the file. If unchecked, the search matches on case as well as value for non- wildcard positions. Search Type Wildcard specifications are similar to wild card specification in DOS. Only the '?' is implemented as the '*' doesn't make a lot of sense. Regular Expression specifications include all the normal stuff. A couple brief commands for those not familiar with regular expressions: . Any character (like DOS ?) ? 0 or 1 of the previous character + 1 or more of the previous character * 0 or more of the previous character ^ match at the beginning of the line $ match at the end of the line [abc] match 'a', 'b', or 'c' Examples: a* match on 'a', 'aa', 'aaaaaaa', etc. a.b match on 'axb', 'ayb', 'azb', etc. a.b* match on 'ax', 'axb', 'axbb', 'ay', 'ab', 'abb' ^a.b matches 'axb' at the beginning of the line __________________________________________________________________________ Date: March 26, 1991 Page: 6 Fileview 1.14 ______________________________________________________________________ a.b$ matches 'axb' at the end of the line Save Saves the current values of the Ignore Ignore Ignore Case Case Case check box and Search Search Search Type. Type. Type. Reset Reset Ignore Ignore Ignore Case Case Case check box and Search Search Search Type Type Type to the saved values. 10. 10. 10. Messages Messages Messages This section describes the various messages that Fileview may generate. This section contains a description of the messages that are specific to Fileview. Other messages may occur because of general windows errors, network problems, etc. Please refer to the appropriate documentation for these messages. File File File does not exist does not exist does not exist Fileview can not open the requested file. This message will occur if you invoke Fileview will a command line file that does not exist or specifies a path that does not exist. This message will also occur if you type in an invalid file or path from the open dialog. Not a valid license Id Not a valid license Id Not a valid license Id You have entered an invalid license id. You must provide a valid license id or cancel the dialog. Text Not Found Text Not Found Text Not Found You have invoked the Search... or Continue Search commands. Fileview can not find a match for the search pattern. WM_COMMAND message nnnn not handled WM_COMMAND message nnnn not handled WM_COMMAND message nnnn not handled This message should never be displayed. If it does, an internal error has occurred. If you receive this message, please record the events leading to the message and contact support. __________________________________________________________________________ Date: March 26, 1991 Page: 7 Fileview 1.14 ______________________________________________________________________ 11. 11. 11. WIN.INI WIN.INI WIN.INI This section describes the contents of the [Fileview] section of the WIN.INI file. iTab iTab iTab The number of spaces that tab expansion creates. lLinN lLinN lLinN Indicates whether line numbers will be displayed or not. A value of 0 indicates that line numbers are not displayed. A value of 1 indicates that line numbers are displayed. lLinT lLinT lLinT Indicates whether line numbers or displacement values will be displayed. A value of 0 indicates that displacement values are displayed. A value of 1 indicates that line numbers are displayed. lRul lRul lRul Indicates whether a ruler will be displayed. A value of 0 indicates that a ruler will not be displayed. A value of 1 indicates that a ruler will be displayed. lSrchC lSrchC lSrchC Indicates whether case is respected or ignored. A value of 0 indicates that case is respected. A value of 1 indicates that case is ignored. lSrchT lSrchT lSrchT Indicates whether wildcards or regular expressions are used. A value of 0 indicates that wild card expressions will be used. A value of 1 indicates that regular expressions will be used. lTab lTab lTab Indicates whether tabs in the file are expanded or not. A value of 0 indicates that tabs will not be expanded. A value of 1 indicates that tabs will be expanded. Regn=hhhhhhhhh Regn=hhhhhhhhh Regn=hhhhhhhhh Is used to store your license identifier. __________________________________________________________________________ Date: March 26, 1991 Page: 8 Fileview 1.14 ______________________________________________________________________ 12. 12. 12. License Information License Information License Information Fileview is distributed as a shareware product. All rights have been reserved by the author. Fileview has not been released into the public domain. If you use Fileview beyond an initial evaluation period, you must purchase a license. Two license options are available. You may purchase one license for each user of Fileview. Alternatively, you may purchase a site license. Fileview is also currently bundled with our FileFind product. If you have purchased a license for Filefind, that license will be recognized by at least all 1.XX versions of Fileview. Duplication and Distribution Restrictions Fileview is a shareware product. It may be copied and distributed for others to evaluate as long as the following rules are followed. They are: 1 The Fileview program, this documentation, and any other accompanying materials may not be modified in any way. 2 A copy of this documentation and all accompanying materials must be distributed along with the program. 3 You may not charge for distributing this program, except for a nominal media and handling charge. In any case, such a charge may not exceed $10.00. 4 Users of Fileview must purchase a license for its use. One license per copy of Fileview, or the alternative site license, is required. Note that this requirement allows you to make as many backup copies as you wish as long as you have a license per user or a site license. 5 If you purchased a disk containing this software from a public domain/shareware software distributor, you have paid the media and handling charges as permitted in 3 above. You have not purchased the required license for Fileview. Purchasing a license is required for continued use. __________________________________________________________________________ Date: March 26, 1991 Page: 9 Fileview 1.14 ______________________________________________________________________ 13. 13. 13. Ordering Information Ordering Information Ordering Information Fileview is registered by completing either the user or site application form and remitting the appropriate amount. Make checks payable to and send payments to: William L. Page P.O. Box 266 Flagtown, New Jersey 08821-0266 Note Note Note Payments must be US funds. Checks must be drawn on or payable through a US bank. If you wish to remit a foreign check, we will attempt to have our bank process it through their collection department if you include a $7 fee. Somehow that doesn't seem worth it. Foreign users are probably better off sending cash. You can order the current version of the program when you register Fileview. You should note the date of this document before ordering the current version. If the date is relatively recent, you probably have the most current version. If you have obtained Fileview from a shareware distributor, it is probably three to six months and several versions old. When you register Fileview, the registration acknowledgement will indicate the current version of the program. You have sixty days to order the current version at the same price at the price noted on the application. __________________________________________________________________________ Date: March 26, 1991 Page: 10 Fileview 1.14 ______________________________________________________________________ 13. 13. 13. Rates Rates Rates Two rate scales are available for licensing Fileview. You may purchase a single user license or a site license. For either, you may simply purchase a license, or you may purchase a license, the current version on disk, and/or a printed copy of the documentation. Refer to the license applications following this section for current rates. The purchase of a license allows you to use Fileview and receive support. As new versions are released, you may obtain them through the various shareware channels. New versions will also be available directly from the author for a nominal materials and shipping charge. __________________________________________________________________________ Date: March 26, 1991 Page: 11 Fileview 1.14 ______________________________________________________________________ Application for Single User License Registration Fileview 1.14 Date: ______________________ To: William L. Page P.O. Box 266 Flagtown, New Jersey 08821-0266 Please register Fileview for: Name___________________________________________________ (Company)______________________________________________ (Title)________________________________________________ Address________________________________________________ City, State Zip _____________________________________ Windows version that I am currently using: ____________ I got FileView from (BBS & Phone #) ___________________ _______________________________________________________ +--------------------------------+---------+-------+---------+ | Item | Unit $ | Quant | Total $ | +--------------------------------+---------+-------+---------+ | FileView | $10 | | | +--------------------------------+---------+-------+---------+ | Current Version on 5 1/4 disk | $6 | | | +--------------------------------+---------+-------+---------+ | Current Version on 3 1/2 disk | $6 | | | +--------------------------------+---------+-------+---------+ | Total | | +--------------------------------------------------+---------+ __________________________________________________________________________ Date: March 26, 1991 Page: 12 Fileview 1.14 ______________________________________________________________________ Application for Site License Registration Fileview 1.14 Date: ______________________ To: William L. Page P.O. Box 266 Flagtown, New Jersey 08821-0266 Please register Fileview for: Name___________________________________________________ (Company)______________________________________________ (Title)________________________________________________ Address________________________________________________ City, State Zip________________________________________ Windows version that I am currently using: ____________ I got FileView from (BBS & Phone #) ___________________ _______________________________________________________ +--------------------------------+---------+--------+--------+ | Item | Unit $ | Quant |Total $ | +--------------------------------+---------+--------+--------+ | First 10 Users | $100 | 1 | $100 | +--------------------------------+---------+--------+--------+ | Users 11-20 | $9 | | | +--------------------------------+---------+--------+--------+ | Users 21-50 | $8 | | | +--------------------------------+---------+--------+--------+ | Users 50+ | $7 | | | +--------------------------------+---------+--------+--------+ | Current Version on 5 1/4 disk | $12 | | | +--------------------------------+---------+--------+--------+ | Current Version on 3 1/2 disk | $12 | | | +--------------------------------+---------+--------+--------+ | Total | | +---------------------------------------------------+--------+ __________________________________________________________________________ Date: March 26, 1991 Page: 13 ----------------end-of-author's-documentation--------------- Software Library Information: This disk copy provided as a service of Public (software) Library We are not the authors of this program, nor are we associated with the author in any way other than as a distributor of the program in accordance with the author's terms of distribution. Please direct shareware payments and specific questions about this program to the author of the program, whose name appears elsewhere in this documentation. If you have trouble getting in touch with the author, we will do whatever we can to help you with your questions. All programs have been tested and do run. To report problems, please use the form that is in the file PROBLEM.DOC on many of our disks or in other written for- mat with screen printouts, if possible. PsL cannot debug pro- programs over the telephone, though we can answer questions. Disks in the PsL are updated monthly, so if you did not get this disk directly from the PsL, you should be aware that the files in this set may no longer be the current versions. Also, if you got this disk from another vendor and are having prob- lems, be aware that some files may have become corrupted or lost by that vendor. Get a current, working disk from PsL. For a copy of the latest monthly software library newsletter and a list of the 3,000+ disks in the library, call or write Public (software) Library P.O.Box 35705 - F Houston, TX 77235-5705 Orders only: 1-800-2424-PSL MC/Visa/AmEx/Discover Outside of U.S. or in Texas or for general information, Call 1-713-524-6394 PsL also has an outstanding catalog for the Macintosh.